Configuring erwinAI Bot

This topic walks you through the configuration of the erwinAI Bot.

Prerequisites

Before you begin, ensure the following prerequisites are met:

• Purchase of the erwinAI Bot Add-On and receipt of a welcome email with the licensing portal URL and license number

  If you haven't received the email, contact your support team.

• Access to the Quest Licensing portal at https://licensing.ism.quest.com

• Permissions to update the DI properties file

• Internet access, including access to the following #genai server endpoint URLs:

  • https://erwindi-chat.ai.ism.quest.com/api

  • https://id.quest.com/auth/realms/ism/protocol/openid-connect/token

Adding License

To add your license to the Quest Licensing portal, follow these steps:

1. Log in to the Quest Licensing portal using the same email address that received the welcome email.

   

2. On the Overview tab, in the License Activation section, click Add License.

   The Add License to erwinAI Bot page opens.

   

3. Enter the license number in the License Number field, and then click Add License. For example, 132-646-868.

   You can view your subscription on the Organization Licenses tab.

   

Assigning Users

After you add the license, you can assign users to the erwinAI bot.

To assign users, follow these steps:

1. Go to the Organization Licenses tab.

2. On the Subscription card, click Manage.

   The license page opens.

   

3. On the Seats tab, click to assign users.

   The Assign Users dialog box appears.

   

   Seats are not related to the number of DI users. Assigning a user seat to the admin who receives the welcome email is sufficient for setup.

4. Enter the same email address that you used to log in to the Quest Licensing portal, and then click Assign.

Enabling the Feature

Once the users are assigned, you need to enable the AI feature.

To enable AI feature, follow these steps:

1. On the Settings tab, click Features.

   

2. In the Features section, next to AI, click Enable Feature.

   The Enable AI dialog box appears.



3. Review the terms of usage and select both the conditions, and then click Apply.

Creating Access Keys

You can now create the access key required to initiate erwinAI.

To create access keys, follow these steps:

1. On the Profile menu, select My Access Keys or go to https://licensing.ism.quest.com/user/access-keys.

   

   The My Access Keys page opens.

   

2. Click Add Access Key.

   

3. Enter a key identifier in the corresponding field, and then click Add. For example, erwinAIBot_key_client. Access key is generated from your email address and this unique identifier.

   In the Access Secret dialog box, Access Key Identifier and Access Key Secret are displayed.

   

4. Click Copy Secret to copy. Save the Access Key Secret. It will not be displayed again.

Updating Properties File in erwin DI

If you are running erwin DI locally, you must add the Key Identifier and Key Secret to the Application.properties file to enable the erwinAI Bot:

1. In your local machine, go to C:\Program Files\Apache Software Foundation\Tomcat10.1_Tomcat10.1.24\webapps\erwinDISuite_AIBot\WEB-INF\configuration\properties.

2. Locate and open the Application.properties file.

3. Add the License Number, Access Key Identifier, and Access Key Secret to the corresponding properties. Set encrypted=false the first time you configure this.
   Ensure that the following URLs are set to the corresponding properties:

   • genai.api.url=https://erwindi-chat.ai.ism.quest.com/api

   • genai.token.url=https://id.quest.com/auth/realms/ism/protocol/openid-connect/token

   

   The license number must include dashes. For example, 132-646-868 not 132646868.

4. Restart Tomcat.

   After Tomcat restarts, the encrypted property is updated to true to ensure secure data handling.

The erwinAI Bot is enabled for you.

Verifying in erwin DI

To verify that the erwinAI Bot is enabled for you, follow these steps:

1. Go to Application Menu> Settings> License Key.

   The License tab appears.

2. Ensure that the GenAI Add-On is set to Enabled.

Configuring Roles for the erwinAI Bot

To configure roles for the erwinAI Bot, follow these steps:

1. Go to Application Menu > Data Catalog > Resource Manager.

   The Resource Manager page appears. By default, the Users tab opens.

   

2. On the Roles tab, select the role to grant access to the erwinAI Bot.

   

3. In the Role section, click Edit.

   

4. In the Permission Tree, select the AI Chat Bot check box, and then click Save.

The erwinAI Bot is configured for the selected role.

The AI Chat Bot option is available only for DI users.